home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / chgenv20.zip / CHGENV.TXT next >
Text File  |  1990-08-22  |  9KB  |  265 lines
  1.  
  2.  
  3.  
  4.                                    CHGENV.EXE
  5.                             A DOS ENVIRONMENT EDITOR
  6.                                        BY
  7.                                  PETER A. HYMAN
  8.                                  (609) 799-2638
  9.  
  10.  
  11.  
  12.      UPDATE VERSION: 8/90
  13.  
  14.      Version  2  of CHGENV contains a bug fix to the original  release,  im-
  15.      proves the screen handling and display, and adds a command line  option
  16.      which  causes  the environment to be sorted only.   The  executable  is
  17.      called CHGENV2.EXE,  however all references in the documentation  refer
  18.      to it as CHGENV.  You may wish to rename the file.
  19.  
  20.      DESCRIPTION:
  21.  
  22.      CHGENV (Change Environment) is a program designed to allow the user  to
  23.      easily change settings in the Environment.   With CHGENV,  the user may
  24.      add to, delete from or modify any of the SETtings currently in effect.
  25.      CHGENV  is particularly useful when a long environment  variable  (e.g.
  26.      PATH) requires modification.   The user need not retype the entire  SET
  27.      command with CHGENV,  merely edit the setting.  New to version 2 is the
  28.      ability to only sort the environment.
  29.  
  30.      USAGE:
  31.  
  32.      CHGENV has two modes of operation:
  33.  
  34.      SORT ONLY:  To only sort the current environment, type
  35.  
  36.      type CHGENV -s or -S [ENTER].
  37.  
  38.      A copyright and statistical messages will be displayed,  then the  mes-
  39.      sage Environment Successfully Updated will be displayed and the program
  40.      will end.  The environment will be sorted in alphabetical order and may
  41.      be view with the DOS SET command.
  42.  
  43.      FULL SCREEN INTERACTIVE MODE:
  44.  
  45.      type CHGENV [ENTER].
  46.  
  47.      CHGENV displays a copyright message followed by the location in  memory
  48.      of  the MASTER copy of the Environment,  its Maximum  allowable  length
  49.      followed  by the current length of all the environment strings in  use. 
  50.      The Maximum length may not be exceeded.
  51.  
  52.      Next,  CHGENV will display all currently SET environment  variables  in
  53.      ALPHABETICAL order.   If more than 16 variables are set,  a scroll  bar
  54.      will be displayed in the left margin.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                     -- 1 --                          Aug 1990   
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                    CHGENV.EXE
  71.                             A DOS ENVIRONMENT EDITOR
  72.                                        BY
  73.                                  PETER A. HYMAN
  74.                                  (609) 799-2638
  75.  
  76.  
  77.  
  78.      There are only three operations which CHGENV performs,  and three  keys
  79.      used to perform them:
  80.  
  81.      INSERT KEY:    Add a New Environment Variable
  82.      DELETE KEY:    Delete Currently Selected Environment Variable
  83.      ALT-C KEY:     Change Currently Selected Environment Variable
  84.  
  85.      Pressing Control-Break,  Control-C or ESCAPE immediately ends the  pro-
  86.      gram.  Pressing F10 ends the session prompting the user if he wishes to
  87.      save the changes.  Even if no edits have been made, the environment has
  88.      been sorted and the Save Changes prompt will always appear.
  89.  
  90.      A highlighter is always visible.   It indicates the  currently-selected
  91.      Environment Variable.   To move the highlighter, the UP or DOWN Cursor,
  92.      HOME or END or RETURN Keys may be used to move about the screen.
  93.  
  94.      ADDING A NEW ENVIRONMENT VARIABLE:
  95.  
  96.      All Environment Variables may be a maximum of 128 characters or the re-
  97.      maining  available environment space,  whichever is less.   The  syntax
  98.      must be:
  99.  
  100.      name=value
  101.  
  102.      where name is the name of the Environment Variable (e.g.  PROMPT),  the
  103.      equal  sign  is mandatory with or without a space in between,  and  the
  104.      value is the text or numeric value to be associated with the  Variable. 
  105.      CHGENV will display a line near the bottom of the screen when INSERT is
  106.      pressed and prompt Add: , followed by a highlighted area.  If the Envi-
  107.      ronment  Variable is more than the screen width,  the  characters  will
  108.      scroll  until done.   Any edit may be completed by pressing the  UP  or
  109.      DOWN cursor,  HOME or END keys or RETURN.   If the Environment Variable
  110.      to  be  added does not contain an equal sign,  or if its  length  would
  111.      cause  the  total Environment Length to exceed its maximum,  and  error
  112.      will be reported.
  113.  
  114.      If  the Environment Variable to be added is the same as one already  in
  115.      the Environment,  it will replace the existing one (although the CHANGE
  116.      option could also be used to edit the existing Environment Variable).
  117.  
  118.      Once editing is completed, the newly-added Environment Variable will be
  119.      sorted into the display.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                     -- 2 --                          Aug 1990   
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                    CHGENV.EXE
  137.                             A DOS ENVIRONMENT EDITOR
  138.                                        BY
  139.                                  PETER A. HYMAN
  140.                                  (609) 799-2638
  141.  
  142.  
  143.  
  144.      DELETING AN ENVIRONMENT VARIABLE:
  145.  
  146.      The currently highlighted Environment Variable may be deleted by press-
  147.      ing the DELETE Key.  When this is done, the variable to be deleted will
  148.      flash and a prompt Delete This Environment String?  will be  displayed. 
  149.      A 'Y' or 'N' in upper or lower case must be entered in response to this
  150.      prompt.   If 'Y'  is entered, the Environment String is deleted and the
  151.      list resorted and the Current Environment Length is recomputed.
  152.  
  153.      CHANGING AN EXISTING ENVIRONMENT VARIABLE:
  154.  
  155.      The screen handling has been overhauled for version 2,  making  editing
  156.      an environment much easier.
  157.  
  158.      An environment variable may be selected by moving the highlighter up or
  159.      down using the Cursor UP, DOWN, HOME or END keys.   The currently high-
  160.      lighted  Environment Variable may be changed by pressing  ALT-C.   When
  161.      this is done,  an edit box is displayed just to the right of the  equal
  162.      sign and the cursor will be positioned at the beginning of the environ-
  163.      ment variable data string.  To scroll the string, use the right or left
  164.      cursor keys.  To delete characters, either the DELETE or BACKSPACE Keys
  165.      may  be used.   Both INSERT and OVERTYPE modes are now supported.   If,
  166.      during  an edit,  you wish to throw away the changes,  pressing  ESCAPE
  167.      will  undo  the changes and return you to the  first  column  position. 
  168.      Pressing  ESCAPE a second time will abort the edit.   Any edit  may  be
  169.      completed  by pressing the UP or DOWN cursor,  HOME or END keys or  RE-
  170.      TURN.  The Screen cursor will move up or down the screen accordingly.
  171.  
  172.      SAVING THE CHANGES:
  173.  
  174.      After all Environment Changes have been completed,  F10 may be  pressed
  175.      to  save the changes.   Replying 'Y' to the Save Changes?  prompt  will
  176.      cause the modified environment to be copied back into the Master  Envi-
  177.      ronment Location.   This is the copy of the environment which is  given
  178.      to  each process or subprocess.   Any TSRs already loaded have  already
  179.      inherited  their  environments and cannot be affected by  this  change. 
  180.      However,  all new commands,  programs or new invocations of  a  command
  181.      processor will inherit the modified environment.
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                     -- 3 --                          Aug 1990   
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                    CHGENV.EXE
  203.                             A DOS ENVIRONMENT EDITOR
  204.                                        BY
  205.                                  PETER A. HYMAN
  206.                                  (609) 799-2638
  207.  
  208.  
  209.  
  210.      DISCLAIMER:
  211.  
  212.      Every  effort has been made to test this program and assure its  integ-
  213.      rity.   If it does not work on your system,  please let me know immedi-
  214.      ately.
  215.  
  216.      This program is being placed in the public domain as shareware.  Please
  217.      distribute  it freely to other BBSs or users.   You should include  the 
  218.      files CHGENV2.EXE and CHGENV.TXT.    You may not ch